home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / The Director Toolkit v1.0.adf / Executes / docs < prev    next >
Text File  |  1987-02-25  |  6KB  |  158 lines
  1.  
  2. |c7|t1|f2Executes|c3|t0|f1|r1
  3.  
  4. The programs in this drawer are designed to be run from the Director,
  5. and provide extension features for Director scripts.|r1
  6.  
  7. While all of them are |c7CLI|c3 commands, they are primarily designed 
  8. to be run using the Director's |c7EXECUTE|c3 command.|r1
  9.  
  10. An exception is the |c7AssignIt|c3 program which is designed to replace a
  11. .film file's icon and provide a running environment for Director films
  12. that is easier to move to hard disks, etc. in the event you are producing
  13. a film for distribution.|r1
  14. |e
  15.  
  16. The programs contained in this section are:|r1
  17.  
  18. |c7|+4SaveIFF|+2- Save a Director screen as IFF file.|r1
  19. |+4FileReq|+2- Director callable standard file requester.|r1
  20. |+4WBMove|+3- Director control over WorkBench screen front/back.|r1
  21. |+4AssignIt|+1 - Replacement .film icon and run program for easier|r1
  22. |+4|+0|+2distribution.|c3|r1
  23.  
  24. Since all of the commands (except AssignIt) are |c7CLI|c3 commands, the 
  25. commands themselves are in the 
  26. |c7ToolKit:commands|c3 directory along with all the other
  27. new |c7CLI|c3 commands.  You can follow the instructions in the 
  28. |c7CLI_Commands|c3
  29. drawer on how to install the commands for your system.|r1  
  30. |e
  31.  
  32. When producing a .film file that requires one of these commands, there
  33. are several ways they can be used:|r1
  34.  
  35. |c7|+51.  Copy to RAM: and use from there for speed.|r1
  36. |+52.  Assume they are in the current C: directory.|r1
  37. |+53.  Reference them in the current directory.|c3|r1
  38. |e
  39.  
  40. The Director's |c7EXECUTE|c3 command does an |c7AmigaDOS|c3 system call 
  41. to the
  42. |c7AmigaDOS|c3 Execute() function (not the same as the AmigaDOS "execute"
  43. command) and contains an anomaly whereby programs being run under
  44. |c7EXECUTE|c3 from a .film file invoked from a normal icon will always think
  45. they are in |c7DF0:|c3|-, no matter where the files actually are.  This 
  46. can make it difficult to insure that the command files can be found in all 
  47. instances.|r1
  48.  
  49. Symptomatic of such a problem would be that you may get various file not found
  50. errors, or unknown command errors due to |c7AmigaDOS|c3 not thinking it is
  51. in the correct directory for some of your |c7EXECUTE|c3 commands.|r1
  52.  
  53. If you experience such difficulty, you will want to investigate the
  54. |c7AssignIt|c3 program, as it will assign the label |c7HERE:|c3 to the 
  55. current directory allowing you to reference such files prefixed with 
  56. |c7HERE:|c3 (see the AssignIt README for more information).
  57. |e
  58.  
  59. |c7Copying to RAM:|c3|r1
  60.  
  61. In order to copy a |c7CLI|c3 command file to |c7RAM|c3 to eliminate disk 
  62. accessing during use, there are a couple of steps you will have to take:|r1
  63.  
  64. |c7|+81. copy the desired command(s) to RAM:|r1
  65. |+82. copy the RUN command to RAM:|r1
  66. |+83. Assign C: to RAM:|c3|r1
  67. |e
  68.  
  69. You can perform these steps with the 
  70. |c7EXECUTE|c3 command something like this:|r1
  71.  
  72. |c7|+8EXECUTE v,"copy HERE:SaveIFF ram:"|r1
  73. |+8EXECUTE v,"copy c:run ram:"|r1
  74. |+8EXECUTE v,"assign c: ram:"|c3|r1
  75.  
  76. And then use the |c7SaveIFF|c3 command as described in the |c7SaveIFF
  77. README|c3 file:|r1
  78.  
  79. |c7|+8EXECUTE v,"saveiff -d HERE:mypicture"|c3|r1
  80. |e
  81.  
  82. The assignment of |c7C:|c3 to |c7RAM:|c3 is only necessary to eliminate 
  83. ALL disk accesses during the running of the final |c7SaveIFF|c3 command.
  84. The |c7EXECUTE|c3
  85. command uses the |c7RUN|c3 command and normally expects to find it in the
  86. |c7C:|c3 directory.  Thus it is necessary to reassign |c7C:|c3 to 
  87. |c7RAM:|c3|-.  
  88. |e
  89.  
  90. Note that
  91. when your film ends, if the |c7C:|c3 directory is still reassigned to 
  92. |c7RAM:|c3|-,
  93. it can cause confusion later when someone trys to run a |c7CLI|c3 command
  94. and finds that it can't be found.  You can use the old |c7FONTS:|c3
  95. trick:|r1
  96.  
  97. |c7|+8EXECUTE v,"assign temp: c:"|r1
  98. |+8EXECUTE v,"assign c: ram:"|c3|r1
  99.  
  100. and later:|r1
  101.  
  102. |c7|+8EXECUTE v,"temp:assign c: temp:"|c3|r1
  103.  
  104. This can also be useful as shown above in being able to reference commands
  105. that were in the original |c7C:|c3 directory (such as the ASSIGN command)
  106. which otherwise will not be able to be located by |c7EXECUTE|c3|-.|r1
  107. |e
  108.  
  109. The |c7AssignIt|c3 program can be very useful in performing these kinds of 
  110. functions, as many of the above |c7EXECUTE|c3|-s can be performed by the 
  111. |c7AssignIt|c3 program instead, which has the added advantage of more
  112. easily being able to undo the assigns after the film file has completely
  113. finished no matter where it may have been completed or aborted.|r1
  114. |e
  115.  
  116. The |c7Enhanced Blit Utility|c3 for instance, uses the |c7FileReq|c3
  117. program, a copy of which is contained in the |c7BlitUtil|c3 directory 
  118. itself so that
  119. the entire |c7BlitUtil|c3 directory can be dragged to a hard disk and work
  120. with no other installation worrys.  After reading the |c7AssignIt|c3
  121. instructions
  122. it may be useful to inspect the |c7Enhanced Blit Utility|c3 
  123. (EBU) icon to see how the |c7EXECUTE|c3|-s were performed.|r1
  124.  
  125. For example, the |c7Blit Utility|c3 will copy the file requester to 
  126. |c7RAM:|c3 before
  127. running the Director film, and delete it afterwards.  In this particular
  128. instance, the |c7RUN|c3 command is not copied so all disk activity is not
  129. eliminated, but speed is enhanced over |c7EXECUTE|c3|-ing the file 
  130. requester from disk with this technique.|r1
  131. |e
  132.  
  133. |c7Assuming Commands in C:|c3|r1
  134.  
  135. If you are prepared to assume for your .film file that the commands
  136. you need will always be in the |c7C:|c3 directory, you can simply specify
  137. them directly without any |c7ASSIGN|c3|-ments or pre-preparation:|r1
  138.  
  139. |c7|+8EXECUTE v,"saveiff -d myfile"|c3|r1
  140.  
  141. Though be advised, the above example will always save |c7myfile|c3 to
  142. |c7DF0:myfile|c3 when such a program is run from the normal .film file
  143. icon.  By specifying the complete pathname, or |c7RAM:myfile|c3|-, or
  144. using a complete path as generated by the file requester for
  145. instance, or using the |c7AssignIt|c3 program and |c7HERE:myfile|c3|-, 
  146. you can eliminate this problem.|r1
  147. |e
  148.  
  149. |c7Assuming the current directory|c3|r1
  150.  
  151. If the |c7EXECUTE|c3 commands you are using are known to be in the current
  152. directory (same directory as the .film file), you should not have 
  153. a problem with |c7EXECUTE|c3 finding the commands themselves and can
  154. use the commands just as if they were in the |c7C:|c3 directory. 
  155. Again as described previously, file name parameters supplied with the
  156. commands may think they are relative to |c7DF0:|c3|-.  The previous 
  157. paragraph listed several ways to cure this side effect.
  158.